home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / printing / pnmtoprt.0 / pnmtoprt / pnmtoprt-2.0 / README < prev    next >
Text File  |  1996-03-28  |  7KB  |  201 lines
  1. pnmtoprt Version 2
  2.  
  3. pnmtoprt is a printer driver for NEC P6 compatible printers (mono and color) to
  4. print PBM graphics.
  5.  
  6. The program only prints the PNM graphic 1:1. Scaling, dithering, smooting ...
  7. must be done with the other PBM tools.
  8.  
  9. For example:
  10.  
  11. giftopnm girldemo.gif | pnmscale -xscale 4 -yscale 4 |\
  12.     pnmsmooth | pnmgamma 10 |\
  13.     ppmdither -dim 4 -red 2 -green 2 -blue 2 |\
  14.     pnmtoprt -d necp6_color -o 360x360dpi\
  15.     -o interlace_180 -o even=fff -o odd=fff >test.prt
  16.  
  17.     lp -P??? test.prt
  18.  
  19. prints the gif file 'girldemo.gif'. (Try it. On my printer it looks quite
  20. pretty :-)).
  21.  
  22. Try also the other example(s) in the file EXAMPLE.
  23.  
  24.  
  25. The program supplies some options to prevent the white stripes in the
  26. output which are typically for pinwriters.
  27.  
  28.    usage: pnmtoprt -d driver [-o opt] [-h] [PNM - file]
  29.               -h .. help
  30.  
  31.     Options for driver 'necp6_color'
  32.       -o 360x360dpi [default] (Max. width: 4896)
  33.       -o 180x180dpi           (Max. width: 2446)
  34.       -o real360x360dpi       (Max. width: 4896)
  35.       -o formfeed -o linefeed -o noreset -o noinit
  36.       -o x_margin=[-]pixel  -o y_margin=[-]pixel
  37.       -o htabs=int (1/120'')
  38.       [-o interlace_360 | -o interlace_180]
  39.       [-o print_odd | -o print_even]
  40.       -o odd=(hex)  [default: 333]
  41.       -o even=(hex) [default: ccc]
  42.       -o odd_cyan=(hex)    -o even_cyan=(hex)
  43.       -o odd_magenta=(hex) -o even_magenta=(hex)
  44.       -o odd_yellow=(hex)  -o odd_yellow=(hex)
  45.       -o even_black=(hex)  -o even_black=(hex)
  46.  
  47. -o 360x360dpi:
  48.     Is the default resolution. The picture will be printed without any
  49.     improving.
  50.  
  51. -o 180x180dpi:
  52.     Prints with lower resolution.
  53.     !! With this option all other options for interlacing will be ignored!!
  54.  
  55.     It makes no sense to beautify the output at low resolution ;-).
  56.  
  57. -o real360x360dpi:
  58.     Prints in "real" 360 dpi. The pinwriter normally can't print adjacent
  59.     pixels. With this option one line will be printed in two passes. One
  60.     pass for the even columns, one pass for the odd columns.
  61.  
  62.     This option makes only sense when printing fulltone pictures. On
  63.     dithered pictures the effect can be cancelled because of the
  64.     dithering matrix.
  65.  
  66. -o formfeed:
  67.     Adds a formfeed after the picture. Without this option the next
  68.     picture will be printed just after the last picture. This option
  69.     is mutually exclusive to -o linefeed.
  70.  
  71. -o linefeed:
  72.     Adds a linefeed after the picture. Without this option the next
  73.     picture will be printed just after the last. This option is
  74.     mutually exclusive to -o formfeed.
  75.  
  76. -o noreset:
  77.     Doesn't reset the printer after printing the picture. Useful when
  78.     printing several pictures.
  79.  
  80. -o noinit:
  81.     Doesn`t init the printer before printing the picture. Also useful when
  82.     printing several pictures.
  83.  
  84. Both options noreset and noinit are useful to prevent the printer to
  85. initialize between when printing several pictures in a row. On my
  86. printer at the top of the paper when linefeed the head will always be
  87. positioned in the middle of the paper to prevent a paper jam.
  88. This costs time. With this option you can prevent this effect.
  89.  
  90. The following options activiate an additional 'interlaced' mode. This mode
  91. can be combined with '-o 360x360dpi' and '-o real360x360dpi'.
  92.  
  93. -o interlace_360:
  94.     In 360 dpi mode one stripe consists of 48 pixels. In the first pass
  95.     the odd lines and in the second pass the even lines will be printed.
  96.     Between the passes there is a linefeed of 1/360'.
  97.     With this option the odd an the even lines of two adjacent stripes
  98.     will be interlaced.
  99.  
  100. -o interlace_180:
  101.     In this mode the 48 pixels of the stripe will be splitted in 24
  102.     lines (each 2 pixels high). The lines of two adjacent stripes will
  103.     be interlaced.
  104.  
  105. The following options can only be combined with '-o interlace_180':
  106.  
  107. -o odd=(hex byte):
  108.     Defines the mask for upper 12 double pixel rows of one stripe.
  109.  
  110. -o even=(hex byte):
  111.     Defines the mask for lower 12 double pixel rows of one stripe.
  112.  
  113. -o odd_<color>:
  114. -o even_<color>:
  115.     Defines the mask for each color seperately. All other masks will keep
  116.     the default value.
  117.  
  118. The following option is for debugging purposes:
  119.  
  120. -o print_odd:
  121.     Prints only the odd lines.
  122.  
  123. -o print_even:
  124.     Prints only the even lines.
  125.  
  126. -o htabs=(integer) (1/120'')
  127. When the distance between two empty columns is greater than the given
  128. value the printer uses htabs to move the head. Usually this option is
  129. turned off. This option will speed up printing but may not be compatible
  130. with other printers. The =(integer) value is optinal. You can only
  131. specify 'htabs' to get the default value.
  132.  
  133. -o x_margin=[-]pixel:
  134. Defines the left margin of the picture in pixels. The value can also be a
  135. negative number.
  136.  
  137. -o y_margin=[-]pixel
  138. Defines the top margin of the picture in pixels. The value can also be a
  139. negative number.
  140.  
  141.  
  142.  
  143. The interlacing works fine (without further tuning) with full tone pictures.
  144. In this case the option '-o interlace_360' is enough.
  145.  
  146. When printing colored pictures you have to dither the picture. Depending on
  147. the colors and the dithering matrix it can happen that one color is only
  148. present on the even or on the odd lines.
  149.  
  150. In this case the effect of interlacing is canceled.
  151.  
  152. For this purpose you can use the '-o interlace_180' option with the possibility
  153. of specifying your own interlace mask.
  154.  
  155. Normally the even and the odd mask should be exclusive so that no lines will
  156. be printed twice.
  157.  
  158. But you can also define a mask of 'fff' for even and odd. Then each stripe will
  159. be printed twice -- but interlaced. Then you have a very good output but
  160. it needs much more color.
  161.  
  162. You can use other masks for example to replace a wrong printing pin of the
  163. pinwriter.
  164.  
  165. To try different masks, you can use the options '-o print_odd' and
  166. '-o print_even' to see the effect of the mask to the interlaced pictures.
  167. You should define the mask in that way that both half-pictures have the some
  168. amount of each color.
  169.  
  170.  
  171. Speed (from fastest to slowest):
  172. -o 180x180dpi:
  173.     One pass per stripe and color.
  174.  
  175. -o 360x360dpi:
  176.     Two passes per stripe and color. Between the two passes there is a
  177.     linefeed of 1/360'.
  178.  
  179. -o real360x360dpi:
  180.     Four passes per stripe and color. Two passes, one for odd and one for
  181.     the even columns, a linefeed of 1/360' and two passes again.
  182.  
  183. -o interlace_360:
  184.     No additional passes.
  185.  
  186. -o interlace_180:
  187.     prints interlaced. But in summary it doubles the passes.
  188.  
  189.     (interlaced_360 sounds better than interlaced_180 but this isn't right.
  190.     you have more options and probably better results with
  191.     interlaced_180 ;-))
  192.  
  193. -o mask*:
  194.     no additional passes.
  195.  
  196.  
  197. gamma correction:
  198.     I am using pnmgamma with a value of 10 for gamma correction. In my
  199.     distribution I missed this program after I had installed 'netpbm'.
  200.     I found the program in the source distribution.
  201.